home *** CD-ROM | disk | FTP | other *** search
/ Shareware Grab Bag / Shareware Grab Bag.iso / 001 / qs2.arc / QS.DOC < prev   
Text File  |  1987-06-17  |  12KB  |  259 lines
  1.                                  QSEARCH2.DOC
  2.  
  3.                                  QSEARCH V2.0
  4.                   (C) 1987 By Rich Olivieri and Vince Deegan
  5.                              ALL RIGHTS RESERVED
  6.  
  7.   Permission is granted to use, copy and distribute freely this TRYWARE 
  8.   version only. The enclosed TRYWARE version will search a maximum of two
  9.   files.  When executed from the DOS commandline the TRYWARE will search 
  10.   the first two files matching a file-pattern.  Additionally from the 
  11.   Bible menus the TRYWARE version will search two Bible files, 
  12.   the Book of Romans and Book of Proverbs.
  13.  
  14. LIST OF FILES:
  15.   If you downloaded QSEARCH from a BBS or information service you
  16.   should check to see if you have all of the following files:
  17.          QS.COM  - executable file
  18.          QS.DOC  - this file
  19.         ICN.REG  - ICN registration form...use this to order QSEARCH
  20.    B20-PROV.OT   - Book of Proverbs
  21.      B45-RM.NT   - Book of Romans
  22.  
  23.  
  24. SET UP FILES:
  25.      *  Place the QS.COM file in the drive and directory of your choice.
  26.         If you plan to call QS.COM from other drives and/or directories then
  27.         you must include the full path at the DOS COMMANDLINE or include the 
  28.         QS.COM drive and directory in the PATH within your AUTOEXEC.BAT file.
  29.  
  30.         EXAMPLES:
  31.           B>A:QS "SEARCH" *.TXT  <-- This will invoke QS from drive A:
  32.                                      and search files matching *.TXT in
  33.                                      the ROOT directory of drive B:
  34.           C:\BIBLE>QS            <-- This will call QS if the QS.COM file
  35.                                      is in the default directory [C:\BIBLE]
  36.                                      or if the QS drive and directory is
  37.                                      in the PATH statement.
  38.  
  39.           NOTE: The two Bible files must be in the default directory.
  40.                 [BK20-PROV.OT & B45-RM.NT]
  41.         
  42.           NOTE: To set the drive and directory of QS.COM in the
  43.                 PATH statement make sure your AUTOEXEC file contains
  44.                 the following line:
  45.                     PATH=C:\DIRECTORY
  46.                          ^     ^---- name of the directory
  47.                          ^------ drive
  48.                                 ^--------------------------^
  49.                                              ^
  50.                                  Subsitute your drive & Directory
  51. TO RUN QSEARCH:
  52.  
  53.     * FROM DOS COMMANDLINE:
  54.  
  55.          QS /CF "SEARCH PHRASE" FILE-PATTERN
  56.  
  57.             /CF - These are two switches or toggles.
  58.              C  - Means CASE is ON or significant ie
  59.                   Caps will only match Caps
  60.  
  61.                   DEFAULT is CASE is  OFF
  62.                   Caps will match caps, Caps and CAPS
  63.  
  64.              F  - Send Results to an output file.
  65.  
  66.                   DEFAULT is OFF ie send results only to the screen.
  67.  
  68.                   NOTE: The FILENAME for the output file is built from
  69.                         the search phrase or QSEARCH.LST is used.
  70.  
  71. "SEARCH PHRASE" - The search phrase can consist of a word or a phrase and
  72.                   must be enclosed in double quotes " ".
  73.  
  74.  FILE-PATTERN   - Any valid DOS filename with or without wildcards can be
  75.                   entered for a FILE-PATTERN.  Wildcards will be expanded
  76.                   according to MSDOS rules.
  77.  
  78.                   EXAMPLES:
  79.                        cat*.txt
  80.                        i?m.*
  81.     * TO GET THE BIBLE MENU:
  82.          ENTER  QS without any additional parameters.
  83.  
  84. GENERAL FEATURES:
  85.  
  86.     SCREEN PAUSES  - QS will pause only when it finds a match and
  87.                      when the screen is filled.  At the screen pauses
  88.                      you can choose to abort the search, continue
  89.                      with screen pauses or continue without screen
  90.                      pauses.
  91.  
  92.     SEARCH SUMMARY - At the end of a search QS will display a summary
  93.                      of the cummulative total of matches and the totals
  94.                      of matches by file.  QS also prints a summary of totals
  95.                      at the top of the screen as it is conducting a search.
  96.  
  97.     SPEED          - QS will search most files at a rate of 35,000 bytes
  98.                      per second.  Higher rates are possible with some
  99.                      files and when CASE is OFF.
  100.                      NOTE: Rate is based on using a hard drive and
  101.                      an X-Turbo 7.14 MHZ IBM/XT Clone
  102.  
  103.  
  104.     TYPES OF FILES - QS will search any PCDOS/MSDOS textfile ie a file
  105.                      containing ASCII text where each line ends with
  106.                      a CR/LF sequence and is not longer than 255 characters.
  107.                      QS will also search binary files for ASCII strings, 
  108.                      but will only print 255 characters of the file for 
  109.                      each match.  Files containing lines longer than 255 
  110.                      can be searched, but the highlighting of matches 
  111.                      maybe off by one character.
  112.  
  113.   QSEARCH is a high speed search program that will search textfiles without 
  114.   an index at a data rate of 35,000+ bytes per sec...or 1 meg in less than 
  115.   30 secs (or the New Testament in 30 secs).  QSEARCH is being distributed 
  116.   by Christian Information Ministries, Intl. (CIM) with the ICN King James 
  117.   Version Bible Data files as an incentive offer to new subscribers of the 
  118.   Informed Christian Network (ICN).   SEE BELOW FOR INFO ABOUT ICN
  119.  
  120.   CIM is offering the ICN Bible Data files, QSEARCH and registration to ICN 
  121.   with the following donation levels: 
  122.  
  123.   For a Gift of   You Receive
  124.   -------------:--------------------------------------------------------
  125.           $35 -   6 MONTHS subscription plus the New Testament and QSEARCH
  126.           $55 -  12 MONTHS subscription plus the whole Bible and QSEARCH
  127.  
  128.   You can purchase QSEARCH and/or the Bible
  129.   Files separately for the following prices.
  130.  
  131.   QSEARCH ONLY .............. $20.00
  132.   QSEARCH & NT .............. $30.00
  133.   QSEARCH & OT .............. $45.00
  134.   QSEARCH & Bible............ $55.00
  135.   Bible Disks only........... $35.00
  136.   Shipping & Handling         $ 3.00 Per Order
  137.   --------------------------------------------------
  138.  
  139.   QSEARCH is written for IBM PC/XTs or very close compatibles. The Bible 
  140.   files come ARCed on 7 DS/DD MSDOS format disks and when expanded the 
  141.   whole Bible requires 4.4 megabytes of storage space [New Testament = 1 
  142.   megabyte].  For color you must have a Color Graphics Adapter card (CGA)
  143.   that is compatible with the IBM CGA.
  144.  
  145.   QSEARCH features
  146.          * color highlighting of items found 
  147.          * screen by screen pauses.
  148.          * Book by Book subtotals and total number
  149.            of finds
  150.          * A menu of the Bible books is displayed
  151.            and a series of books or a range of books
  152.            to be searched can be selected.
  153.          * Searches are conducted case sensitive
  154.            or case insensitive 
  155.          * Words or phrases can be entered
  156.            as search strings.
  157.          * QSEARCH does "root" searches...so a search for 
  158.            FAITH will return: FAITH, FAITHful, FAITHless etc.
  159.          * Results can be sent to a file for later editing
  160.            and printing
  161.  
  162.         ** FREE updates will be available here on ICN to
  163.            all who register now.  
  164.         ** Can be used with any DOS textfile.
  165.  
  166.   NO WARRANTY IS STATED OR IMPLIED EXCEPT THAT DEFECTIVE DISKS WILL
  167.   BE EXCHANGED.
  168.  
  169.   QSEARCH HAS BEEN DEVELOPED WITH TEAMWARE UTILITIES.
  170.  
  171.   REVISION HISTORY :
  172.       V1.0 Original release
  173.       V1.1 Cosmetic changes, changed price structure
  174.       V2.0 Cosmetic changes, added commandline parameters, added end of
  175.            search summary, added wildcards to filespecs.
  176.  
  177.   PLEASE SEE THE ENCLOSED REGISTRATION FORM IF YOU WOULD LIKE TO
  178.   GET A COPY OF QSEARCH AND THE KING JAMES BIBLE ON DISK.
  179.  
  180. ICN KJV BIBLE FILES:
  181.      The Bible files that accompany QSEARCH are the ICN King James Bible
  182.   data files.  The text of these files was obtained and used by
  183.   permission from Computers For Christ BBS #1.  The original files
  184.   were in 40 column text format and were converted to a "flat-file"
  185.   format with most verses contained on a single line of 255 characters.
  186.   Where a verse was longer than 255 characters it was split into one
  187.   or more lines with a letter appended to the chapter/verse number to
  188.   represent which line it was. EXAMPLE: 10:01a, 10:01b etc.
  189.   Better than 90 percent of all the verses were placed on one single line.
  190.      The original files were typed in by users of Computers For Christ
  191.   BBS using the public domain version of the King James Bible.  ICN reviewed 
  192.   the Bible files several times for format and spelling errors, but it is
  193.   possible that typographical errors are still present in the text.
  194.   ICN will continue to proof-read the files and post any changes in an
  195.   errata file.  Users of QSEARCH and/or ICN are encouraged to report any
  196.   errors found to ICN at the address below or through the ICN BBS.
  197.   Hundreds of hours were put into the preparation of the Bible files and
  198.   as such ICN has copyrighted the files in their present format. 
  199.      This copyright does not extend to the text itself, nor is it meant to
  200.   to restrict the distribution of the ICN Bible files for the purpose
  201.   of developing Christian Educational software.  The ICN Bible files
  202.   may be distributed freely in their present format so long as changes
  203.   are not made to the text except to correct the text in accordance
  204.   with the King James Bible and with the following exceptions. 
  205.  
  206.     *  The ICN Bible files maybe not be used with or as a promotion for any
  207.   commercial product without the express written permission of Christian 
  208.   Information Ministries or ICN.  
  209.     *  The ICN Bible files may be posted on any BBS or Information
  210.   service ONLY WITH the expressed written permission of Christian Information
  211.   Ministries or ICN.  ICN wishes to reserve the right to determine
  212.   where the files are posted.  The ICN Bible files are distributed free
  213.   except for a distribution fee of $5.00 per disk.
  214.  
  215.   [The QSEARCH TRYWARE Files are OK to copy and to post]
  216.   ***********************************************************************
  217.  
  218.                      THE INFORMED CHRISTIAN NETWORK (ICN)
  219.  
  220.              ICN is a national Christian information and research
  221.          ministry to ministries and individuals. ICN seeks to feature 
  222.          databases, indexes, lists, directories, news, schedules, ministry 
  223.          resources, on-line Bible studies, messaging, conferencing, private 
  224.          E-Mail, special interest groups (SIGs), Christian software and 
  225.          more. 
  226.  
  227.              Ministries, organizations or individuals seeking more
  228.          information on how to participate and take advantage of this 
  229.          dynamic and powerful support tool should contact:
  230.  
  231.                   The Informed Christian Network
  232.                   1303 W. Buckingham Rd. #103/162
  233.                   Garland, TX. 75040
  234.  
  235.          ** This is our mailing address. Our offices are located at
  236.             2077 N. Collins Blvd.
  237.             Richardson, TX
  238.  
  239.          Voice line:  214-271-2487 10am-4pm or 690-1975 12pm-6pm M-F
  240.   
  241.          BE OUR GUEST - Dial our BBS line and Enter GUEST at the ID#
  242.                         prompt.
  243.  
  244.          BBS line :  214-271-2487 300/1200/8/N/1 4pm-10am CST M-F, 24hr S-Su
  245.                   [ Enter GUEST at the ID# prompt to visit and tour ICN ]
  246.  
  247.          CIM is a non-profit, tax-exempt organization.  All gifts are
  248.          tax-deductible.
  249.                            **************************
  250.          NOTE:
  251.          ** ICN is still in the development stage and some features
  252.          are not fully implemented.
  253.        
  254.          ** The voice and data line information will be changing when 
  255.          TELENET access is implemented. Please be aware that there will be 
  256.          updates on this information. ICN should be contacted before using 
  257.          the above text if more than 60 days has elapsed from the date of 
  258.          this document and you have no new information. 
  259.